home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / graphics / pcxdmp90.arj / PCXLAB.DOC < prev    next >
Text File  |  1993-10-17  |  17KB  |  388 lines
  1.  
  2.                         PCXLAB 1.10
  3.  
  4.                 Copyright (c) Jesper Frandsen
  5.  
  6.                       October 17th, 1993
  7.  
  8.               =================================
  9.  
  10.  
  11.  
  12. DISCLAIMER
  13. ----------
  14. This product is distributed AS IS. The author specifically disc-
  15. laims all warranties, expressed or implied, including, but not
  16. limited to, implied warranties of merchantability and fitness for
  17. a particular purpose with respect to defects in the diskette and
  18. documentation, and program license granted herein, in particular,
  19. and without limiting operation of the program license with
  20. respect to any particular application use or purpose. In no event
  21. shall the author be liable for any loss of profit or any other
  22. commercial damage including but not limited to special, in-
  23. cidental, consequential or other damages.
  24.  
  25.  
  26. LICENSING AGREEMENT
  27. -------------------
  28. PCXLAB is copyrighted software and all rights are reserved.
  29. PCXLAB may not be changed or modified in any way except by the
  30. author. PCXLAB is part of the PCXDUMP system. The PCXDUMP system
  31. is SHAREWARE and may be freely distributed as long as it remains
  32. in its complete form with all support and documentation files. It
  33. may be used for a 10 day free trial period. Regardless of how the
  34. copy is obtained, it is requested that all users comply with the
  35. following licensing and registration provisions if they continue
  36. to use it after the 10 day trial period. Should you find this
  37. program useful, you must register it; you will then be provided
  38. with the latest releases of the PCXDUMP system.
  39.  
  40.  
  41. OVERVIEW OF PCXLAB
  42. -------------------
  43. *     It can be used on any color EGA, VGA or SVGA display card
  44.       (except EGA mono).
  45.  
  46. *     It can show any 2, 16, 256 and 16.7 million (24 bit) color
  47.       PCX file in both 16 and 256 color modes. However viewing
  48.       256-color and 16.7 million-color pictures in 16 color will
  49.       only give you a hint of what the picture looks like.
  50.       Viewing 24 bit pictures in 256 color is acceptable. If the
  51.       images displayed are bigger than the current resolution you
  52.       can scroll the images around FAST with the arrow keys and
  53.       PgDn & PgUp. You can also change resolution with '+' and
  54.       '-'.
  55.  
  56. *     It detects the following SuperVGA card and uses their HiRes
  57.       modes in 16 or 256 colors: ATI-VGA, Trident, Genoa, Para-
  58.       dise, Tseng 3000, Tseng 4000, MXIC, Realtek, OAK-37,
  59.       OAK-67, OAK-77, Video7, Ahead A/B, Chips & Tech 451/452/453
  60.       and VESA compatible cards.
  61.  
  62. *     On HiColor or TrueColor cards, you can view 24 bit colors
  63.       PCX files in 32768 colors or 16.7 million colors (TrueColor
  64.       card needed for this).
  65.       PCXLAB will use the HiColor extensions on these cards:
  66.       Tseng ET 4000, Paradise, Realtek, OAK-77, Trident, ATI,
  67.       VESA. With the proper VESA-driver, you will be able to show
  68.       images in 16.7 million colors (if supported by videoa-
  69.       dapter).
  70.  
  71. *     It has a neat file browser, so you can walk through all
  72.       your directories on your harddisk without leaving PCXLAB.
  73.       There is a limit of 2000 PCX-files per directory (you are
  74.       not likely to hit this limit!). You simply use the cursor
  75.       arrows or PgUp or PgDn to select the file you want to see.
  76.       Press Enter to view file.
  77.  
  78. *     The PCX-files must be no larger that 3800 pixels wide,
  79.       which should be more than enough.
  80.  
  81. *     You can easily set up a slideshow by tagging a number of
  82.       files and then hitting F8 (to start the slideshow). You
  83.       must tag at least 2 files to have a slideshow.
  84.  
  85. *     PCXLAB will detect which video modes your videocard can
  86.       use, and you can easily switch between these modes by
  87.       pressing F2 (or + & -).
  88.  
  89. *     It is FAST! PCXLAB is written in a high level language and
  90.       assembler for all the screen and unpacking operations.
  91.       Compared with the great shareware fileviewer VPIC (which
  92.       can show a large number of formats, not only PCX), PCXLAB
  93.       is 30%-700% faster with an average about 2 times faster as
  94.       VPIC!
  95.  
  96. *     Converts PCX-files to other fileformats: Postscript,
  97.       Windows BMP, Amiga LBM, TIFF, Targa TGA, Wordperfect WPG.
  98.  
  99. *     Manipulate PCX-files:
  100.       1) Convert color files to monochrome with Floyd&Steinberg
  101.          or Burkes dithering.
  102.       2) Reduce 256 or 16.7 million color PCX-files to 16 or 256
  103.          colors.
  104.       3) Convert color PCX-files to gray scaled PCX-files.
  105.  
  106. *     Shows both PCX-files and ANS-files (ANSI text files)
  107.  
  108. *     Shows images from command line.
  109.  
  110. PCXLAB will NOT show GIF, TGA, LBM, WPG, BMP, EPS, TIFF images
  111. even though they may apper in the file browser.
  112.  
  113. USAGE
  114. -----
  115. PCXLAB [/CHIPSET=number] [/AUTO] [/SKIPVESA] [/PCXONLY] [files]
  116.  
  117. If one or more arguments are valid filenames on PCX- or ANS-
  118. files, these will be showed. Otherwise the PCXLAB will start as
  119. usually.
  120.  
  121. If PCXLAB somehow fails to recognize your video adapter that you
  122. know is on the list below, you can force PCXLAB to use it with
  123. the /CHIPSET switch. The number must be in the range 2-23:
  124.  
  125. Number  Chipset            Number    Chipset
  126. ----------------------     -------------------
  127.    0  UNSUPPORTED            12  OAK-67
  128.    1  RESERVED               13  Video 7
  129.    2  EGA card               14  Ahead A
  130.    3  VGA card               15  Ahead B
  131.    4  ATI Wonder             16  Chips & Technology 451
  132.    5  Trident                17  Chips & Technology 452
  133.    6  Genoa                  18  Chips & Technology 453
  134.    7  Paradise               19  VESA
  135.    8  Tseng ET 3000          20  Tseng ET 4000 TrueColor
  136.    9  Tseng ET 4000          21  OAK-77
  137.   10  Tseng ET 4000 HiColor  22  MXIC
  138.   11  OAK-37                 23  Realtek
  139.  
  140. By forcing PCXLAB to use your adapter you will not be able to use
  141. your videocards HiColor extension (if it has any)!
  142.  
  143. If you invoke PCXLAB with argument /AUTO, PCXLAB goes to AUTO,
  144. which automatically selects a resolution which will display the
  145. whole picture.
  146.  
  147. When PCXLAB tries to identify your video card it will always
  148. treat your video card as a VESA card if you have a VESA-driver
  149. installed because the very first thing PCXLAB checks, is the
  150. presence of a VESA-driver. If you install PCXLAB with the
  151. /SKIPVESA option no check for a VESA-driver is performed.
  152.  
  153. The /PCXONLY switch will tell PCXLAB only to scan for PCX-
  154. files.
  155.  
  156. PCXLAB will use XMS for temporary storage when viewing or
  157. converting PCX images. If there is not enough available XMS
  158. memory, PCXLAB will use the disk for temporary storage.
  159. You can tell PCXLAB where to place the temporary file with the
  160. environment variables PCXTMP, TEMP or TMP.
  161. First PCXLAB will check if PCXTMP is defined and points to a
  162. valid location. If that is not the case PCXLAB will check the
  163. TEMP variable and then if necessary the TMP variable.
  164. If you put the following line in your AUTOEXEC.BAT file
  165.  
  166. SET PCXTMP=E:\
  167.  
  168. PCXLAB will use the root of disk E: for temporary files. If you
  169. choose to use your extended memory as a RAM disk, you should make
  170. the PCXTMP environment variable point to your RAM disk.
  171.  
  172.  
  173. FILE CONVERSION - F3
  174. --------------------
  175.  
  176.   WPG FILES - MAXIMUM BITS: 8 (OR MAYBE 4)
  177.   ----------------------------------------
  178.   These are the native import graphic files for WordPerfect. These
  179.   files can contain both bitmaps and line art, or vector graphics.
  180.   PCXLAB will only generate the bitmapped part of them. PCXLAB will
  181.   generate with WPG files having one, four or eight bits of color
  182.   information, that is, monochrome files, sixteen-color files and
  183.   256-color files.
  184.   The WPG specification allows for 256-color files. As of this
  185.   writing, WordPerfect itself would not read them. If you wish to
  186.   use 256-color images in a WordPerfect document, you might want to
  187.   either reduce them to sixteen colors or dither them to mono-
  188.   chrome, depending upon what you will be outputting them to.
  189.  
  190.   BMP FILES - MAXIMUM BITS: 24
  191.   ----------------------------
  192.   These are the files which are used as "wallpaper" under Windows
  193.   3. They can be created using the version of PC Paintbrush
  194.   supplied with Windows. BMP files use no image compression, as the
  195.   intention appears to be to make them fast to load. Plan on your
  196.   BMP files being very large. There is a very important aspect of
  197.   color BMP files which you should bear in mind when you use this
  198.   format. Windows uses a fixed palette which Windows Paint cannot
  199.   go about changing, as doing so would make the screen and border
  200.   colors change too.
  201.   This means that transferring an image to the BMP format will
  202.   generally result in some color shifts when BMP files are imported
  203.   into Windows applications.
  204.   The BMP format can support 24-bit files, which PCXLAB does
  205.   generate. However, as of this writing importing a 24-bit BMP
  206.   image into Windows Paint results in a noticeable color shift.
  207.   This appears to be a peculiarity of Windows Paint.
  208.  
  209.   EPS FILES - MAXIMUM BITS: 8
  210.   ---------------------------
  211.   The EPS format... encapsulated PostScript... is not really a
  212.   bitmapped format at all. However, it may contain bitmapped data.
  213.   PostScript cannot be interpreted directly by most PC applica-
  214.   tions. As such, an EPS file which is to be imported into an
  215.   application such as Ventura Publisher or PageMaker also includes
  216.   a "preview". A preview is a small black and white TIFF image
  217.   which will show you a rough idea of what the EPS file will look
  218.   like.
  219.   PCXLAB will not generate a preview.
  220.   If you import an EPS file into Ventura, for example, the screen
  221.   image you see will be the preview but the data printed to your
  222.   printer will be the PostScript data itself.
  223.   PCXLAB can transform PCX-files with between 1 and 24 bits of
  224.   color information ... between two and 16.7 million colors ...
  225.   into EPS files. Images with more than two colors will be turned
  226.   into PostScript halftones.
  227.   Please note that the EPS files which PCXLAB creates are only
  228.   intended to be printed. You cannot read them into applications
  229.   such as Corel Draw or Adobe Illustrator. These applications will
  230.   not accept the large mounts of bitmapped data which a PCXLAB EPS
  231.   file contains. For the most part, using EPS files in this way is
  232.   no longer necessary. Applications which import EPS files will
  233.   usually allow you to import TIFF files as well, which will
  234.   provide you with much better halftoning and screen control.
  235.  
  236.   TIFF FILES - MAXIMUM BITS: 24
  237.   -----------------------------
  238.   PCXLAB generates 1, 4, 8 or 24 bit TIFF files. Color TIFF files
  239.   are useful in Corel Draw, among other places.
  240.   Corel Draw 3.0 will import color TIFF files for inclusion in CDR
  241.   graphics. Due to the complicated nature of TIFF-files PCXLAB will
  242.   only dump uncompressed TIFF. This will allow almost any TIFF-
  243.   reader to read the files generated by PCXLAB without choking.
  244.  
  245.   IFF/LBM FILES - MAXIMUM BITS: 24
  246.   --------------------------------
  247.   These started out on the Amiga. The IFF file standard is
  248.   extremely flexible, and allows all sorts of things besides images
  249.   to be stored in IFF files. IFF files are found on the PC having
  250.   been ported from Amiga systems. They are also created on the PC
  251.   by several applications such as Electronic Arts' Deluxe Paint
  252.   package and Digital Vision's Computer Eyes video scanner board.
  253.   In the first case they are given the extension LBM. In the second
  254.   they are given the extension CE. The basic file structure is the
  255.   same, however. The standard IFF image files are called ILBM,
  256.   compressing all images as planes. This is much slower, but such
  257.   files will be readable by pretty well all IFF readers... even if
  258.   you port them back to the Amiga.
  259.   This is how PCXLAB creates IFF files. Unfortunately, there is a
  260.   problem with old versions of Deluxe Paint which will occasionally
  261.   stop reading some files part way through the image. This happens
  262.   to IFF files from sources other than PCXLAB, so it is probably a
  263.   bug in these versions of Deluxe Paint.
  264.  
  265.   TGA FILES - MAXIMUM BITS: 24
  266.   ----------------------------
  267.   The Truevision Targa format is used by several high end paint
  268.   programs and things like ray tracing packages. It can handle
  269.   images with up to sixteen million unique colors. PCXLAB will
  270.   generate 1, 4, 8, or 24 bit TGA files. As with TIFF files, PCXLAB
  271.   will only generate uncompressed TGA files.
  272.  
  273. DITHERING - F4
  274. --------------
  275. Dithering is a sort of magical process by which color images can
  276. be converted into pretty attractive black and white versions for
  277. reproduction on a monochrome screen or a black and white laser
  278. printer. Note that source files for dithering must have more than
  279. one bit of color information per pixel.
  280. Dithering often works a lot better if you scale the original
  281. image up. PCXLAB lets you dither with images from "size as" up to
  282. 300 percent expansion. Note that the F4 function only dithers to
  283. monochrome. Color dithering is handled by one of the functions of
  284. the F5 key.
  285. Dithering is a fairly slow process, and the better the dithering
  286. algorithm, the slower it gets.
  287. If you have PCXLAB dither a file, it will create a new file for
  288. you of the type selected and with "$" as the first char in the
  289. name. Thus PICTURE.PCX could be dithered to $ICTURE.PCX, for
  290. example. PICTURE.PCX would be left untouched.
  291. The two dithering algorithms use what is called "error diffu-
  292. sion". These produce really nice looking dithers, but they are
  293. quite slow. The fastest, and least attractive, is Floyd&Stein-
  294. berg. The better, and slower, is Burkes (in my opinion).
  295. It is possible to adjust the brightness and contrast of dithered
  296. images with the GAMMA and CONTRAST values. It is also possible to
  297. invert the dithered image.
  298.  
  299.  
  300. COLOR REDUCTION - F5
  301. --------------------
  302. This function allows you to create destination files with fewer
  303. colors than the source files they are derived from. You can use
  304. this function, for example, to reduce a 256-color file to a
  305. 16-color one. It is particularly useful for reducing 24-bit files
  306. to 256-color files.
  307.  
  308.   Monochrome dithering
  309.   --------------------
  310.   Whenever you reduce the number of colors in a file, some image
  311.   information will get lost. The simplest form of color reduction
  312.   is "remapping". This simply means that the destination image will
  313.   have the best color palette it can, and that all the pixels in it
  314.   will be replaced with colors from that palette. The results are
  315.   usually not very attractive.
  316.  
  317.   Color dithering
  318.   ---------------
  319.   Color dithering, also available in this function, can produce
  320.   decidedly better results. With color dithering, you can reduce
  321.   24-bit files to eight bits with very little loss of detail or
  322.   color resolution.
  323.   If you have PCXLAB color dither a file, it will create a new file
  324.   for you of the type selected and with "!" as the first char in
  325.   the name. Thus PICTURE.PCX could be dithered to !ICTURE.PCX, for
  326.   example. PICTURE.PCX would be left untouched.
  327.  
  328.   Gray scale
  329.   ----------
  330.   This function creates a gray scale destination image from a color
  331.   source image. The number of bits of color will remain the same,
  332.   although when grayscaling a 24-bit image, the destination image
  333.   will be an 8-bit image.
  334.   If you have PCXLAB dither a file, it will create a new file for
  335.   you of the type selected and with "#" as the first char in the
  336.   name. Thus PICTURE.PCX could be dithered to #ICTURE.PCX, for
  337.   example. PICTURE.PCX would be left untouched.
  338.  
  339.  
  340. PRINTING - F6
  341. -------------
  342. You can print PCX-files to a either an EPSON compatible printer
  343. or a HP LaserJet compatible printer with PCXLAB. However your
  344. PCX-file must satisfy the following conditions:
  345.  
  346. 1) It must a monochrome PCX-file
  347. 2) It must be no wider than 640 pixels (MATRIX-printer)
  348.   (2000 pixels for a HP LaserJet)
  349.  
  350. You can only print one file at a time, no matter how many you
  351. have tagged. You will be asked if you want to invert the output,
  352. the density on the printer, output resolution and which printer
  353. port (1, 2 or 3).
  354.  
  355.  
  356. AUTO/LOCK - F7
  357. --------------
  358. Pressing F7 goes to AUTO, which automatically selects a resolu-
  359. tion which will display the whole picture. Pressing F7 goes back
  360. to LOCK, which forces the default resolution (above) no matter
  361. what size the image is.
  362.  
  363.  
  364. VIEW SLIDESHOW - F8
  365. -------------------
  366. Pressing F8 will do a slide show of the tagged files until ESC is
  367. pressed.
  368. Alt+D prompts for a new slide delay time in seconds. You must tag
  369. at least 2 files to start the slideshow.
  370.  
  371.  
  372. RESCAN DIRECTORY - F9
  373. ---------------------
  374. Pressing F9 will cause PCXLAB to rescan the current directory for
  375. PCX and ANS-files. If you activate PCXDUMP from within PCXLAB,
  376. PCXDUMP will create new PCX-files that does not appear in the
  377. file selection window. If you press F9 PCXLAB will scan the
  378. directory and the new files will appear in the file selection
  379. window.
  380.  
  381.  
  382. CHANGE DRIVE - F10
  383. ------------------
  384. Press F10 to change drive.
  385.  
  386.  
  387. ------------------ End of document ---------------------------
  388.